跳到主要内容

API 问答

API 问答集(Q & A)​

01. 开放平台官网地址是？​

1、开放平台官网 https://developer.debox.pro/user/login

02. 参数 group_id是怎么获取的 ?​

1、打开app，进入某个群，点击右上角的分享按钮，在底部弹出的界面中选择“复制链接”，id即为group_id
示例：https://m.debox.pro/group?id=fxi3hqo5，其中fxi3hqo5为group_id

03. 为什么调用接口发群组消息，群组里面没有接收到 ?​

1、群组里面人数至少3人才可以接收消息。

04. 为什么调用接口发消息，显示的是ChatBot发的？​

1、开发者需要在开放平台后台，绑定对应的DeBox用户。 bot消息将以该DeBox用户的名义发送。
2、绑定DeBox用户步骤如下：
Alt text

05. 如何调用接口向群组发“纯文字”消息？​

1、开发者需要在开放平台后台申请开发者key；
2、在开发者后台绑定对应的DeBox用户；
3、下载go-sdk，通过go语言实现bot消息发送，demo下载地址：https://github.com/debox-pro/debox-chat-go-sdk
4、通过js-http实现bot纯文字消息发送，接口为/send_robot_group_message，示例：

curl -X POST -H "Content-Type: application/json" -H "X-API-KEY: t2X........AlEF6" 
-d '{"to_user_id":"uvg2p6ho","group_id":"fxi3hqo5","object_name":"RC:TxtMsg",
"message":"i am message sent by bot"}'  
"https://open.debox.pro/openapi/send_robot_group_message"

06. 如何调用接口向群组发“图片文字”消息？​

1、开发者需要在开放平台后台申请开发者key；
2、在开发者后台绑定对应的DeBox用户；
3、下载go-sdk，通过go语言实现bot消息发送，demo下载地址：https://github.com/debox-pro/debox-chat-go-sdk
4、通过js-http实现bot消息发送，接口为/send_robot_group_message，示例：

curl -X POST -H "Content-Type: application/json" -H "X-API-KEY: t2X........AlEF6" 
-d '{"to_user_id":"uvg2p6ho","group_id":"fxi3hqo5","object_name":"RCD:Graphic","href":"https://debox.pro/"
"title":"i am title","content":"i am content 点我下 https://debox.pro/","message":"https://data.debox.space/dao/newpic/one.png"}'  
"https://open.debox.pro/openapi/send_robot_group_message"

07. 如何调用接口向私人发消息？​

1、开发者需要在开放平台后台申请开发者key；
2、在开发者后台绑定对应的DeBox用户；
3、下载go-sdk，通过go语言实现bot消息发送，demo下载地址：https://github.com/debox-pro/debox-chat-go-sdk
4、通过js-http实现bot消息发送，接口为/send_robot_message

 curl -X POST -H "Content-Type: application/json" -H "X-API-KEY: t2X........AlEF6" 
 -d '{"to_user_id":"uvg2p6ho","object_name":"RCD:Command","message":"i am a message to user from bot"}'  
 "https://open.debox.pro/openapi/send_robot_message"

08. 登录授权示例 ？​

https://app.debox.pro/oauth/authorize/?app_id=ohpdAP9W55gyXeJ0&grant_type=authorization_code&scope=payment&response_type=code&pay_info=loginTest&redirect_uri=https://docs.debox.pro/demo/a.html

09. 积分支付示例 ？​

https://app.debox.pro/oauth/authorize?app_id=ohpdAP9W55gyXeJ0&scope=payment&grant_type=onetime_token&amount=0.01&payer_user_id=ii0k2v5n&receiver_user_id=rqg6g4j1&pay_type=send&pay_info=test&redirect_uri=https://docs.debox.pro/demo/a.html

10. 授权成功后，为何没有跳转到redirect_uri ?​

1、redirect_uri 地址不对，访问不了；
2、地址正确，但带有？#:% 等特殊字符 ,需要用encodeURIComponent编码
3、参数为汉字，需要用encodeURIComponent编码；比如 pay_info=支付，需要对“支付”进行编码
4、redirect_uri需要是https地址，否则在iOS上打不开（Android和web上是可以的）

11. 登录授权成功后，在app端能进入redirect_uri页面，但在web端浏览器上一直initialization转圈？​

1、web端必须带上response_type=code参数，才能正常拉起授权页面，进入redirect_uri页面

12. 支付授权环节，报error code = -2011 ？​

1、请按规范传参数，不要少传，也不要多传入，否则会出现意想不到的错误。 比如多传入user_id参数，就可能报code = -2011 错误。

1、需要在开放平台上配置app logo参数。

14. 授权页面不显示DApp名称？​

1、需要在开放平台上配置app name 参数。

15. 积分支付的参数中，谁是支付方？ 谁是收款方？​

1、pay_type代表授权者的身份。 如果其值为send，则表示授权者为支付方；如果其值为receive，则表示授权者为收款方；
2、开发者的身份为授权者的对手方。 即如果授权者为send（payer），则开发者为receiver；如果授权者为receive（receiver），则开发者为payer;
3、pay_type的值决定了授权者和开发者的身份，先定pay_type，而后定payer_user_id、receiver_user_id；
4、pay_type=授权者=send|receive , 确定了授权者身份，开发者自然为另一身份。
5、payer_user_id、receiver_user_id 只能来自于授权者和开发者 ，并且必须根据pay_type值正确填写，否则会各种报错。

16. 实验室 ——> DApp ——> 我的收藏里，为何DApp的logo没有显示？​

1、DApp收藏中的logo路径是https://domain/favicon.ico
2、请把DApp的logo命名为favicon.ico，并确保 https://domain/favicon.ico 能正确取到自己的logo

17. 什么是授权临时票据（code）？​

1、第三方通过code进行获取access_token的时候需要用到，code的超时时间为5分钟，一个code只能成功换取一次access_token即失效。code的临时性和一次性保障了DeBox授权登录的安全性。

18. 什么是授权作用域（scope）？​

1、授权作用域（scope）代表用户授权给第三方的接口权限。

19. 代码逻辑都对，为何拉不起来支付页面？​

1、gasprice给的太低，小于base价格。
2、资产不足。资产余额小于转账金额+gas费。
3、网络不好，由于区块链一些节点在境外，可能存在因网络不通导致无法正常转账,科学上网。

20. 如何判断浏览器是否内置了DeBox环境?​

userAgent包含DeBox

  const isDeBox = !!window?.navigator?.userAgent?.includes('DeBox')